home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 422_02 / laptalk / laptalk.doc < prev    next >
Text File  |  1994-03-20  |  47KB  |  1,054 lines
  1.     
  2.     
  3.     
  4.     
  5.     
  6.     
  7.     
  8.     
  9.     
  10.     
  11.     
  12.     
  13.     
  14.     
  15.     
  16.                                  L A P T A L K
  17.     
  18.                                        A
  19.                                       Tiny
  20.                                Telecommunications
  21.                                     Program
  22.                                       for
  23.                                 Laptop Computers
  24.     
  25.                                   Release: 1.1
  26.     
  27.                                Revised: 30-Aug-93
  28.     
  29.     
  30.     
  31.     
  32.     
  33.     
  34.     
  35.     
  36.     
  37.     
  38.     
  39.     
  40.     
  41.     
  42.     
  43.                        Copyright 1991-1994 Dave Dunfield
  44.                               All rights reserved.
  45.     LAPTALK Users Guide                                              Page: 1
  46.  
  47.  
  48.     1. INTRODUCTION
  49.     
  50.           I first conceived of LAPTALK when I did a great deal of  traveling
  51.        with a small 8088 dual-floppy (no hard disk) laptop computer. Being a
  52.        shareware author, I try to log into local BBS's wherever I travel, to
  53.        upload the latest versions of my software.
  54.     
  55.           Some of my archives are quite large, requiring up to 1/2  hour  to
  56.        transfer (at 2400 bps). Using the floppies  was  unacceptable,  since
  57.        the drives just sat  there  starting  and  stopping....  The  obvious
  58.        solution  was  to  define  a  RAMdisk,  allowing  smooth,  quiet  and
  59.        non-destructive operation.
  60.     
  61.           Then I ran into a small problem.... The  telecomm  packages  which
  62.        contained the features I used were all very large, typically  200-300
  63.        Kbytes in size. This not only used up a good portion of the 640K  ram
  64.        on my laptop (thereby reducing the size of my RAMdisk), but  it  took
  65.        lot of space on the 720K floppy drive,  and  took  FOREVER  to  load.
  66.        There just had to be a better solution...
  67.     
  68.           I decided to write my own very small "no frills" terminal program,
  69.        which would still have the features I needed, which were:
  70.     
  71.           1) Reasonable subset of ANSI (VT100) terminal emulation
  72.           2) Built in capture and upload of ASCII files.
  73.           3) Ability to link to external transfer protocols
  74.           4) Powerful "command" language to automate uploads etc.
  75.           5) A simple "host" capability for remote access.
  76.     
  77.           The results  of  my  effort  was  LAPTALK,  a  ".COM"  file  which
  78.        addresses the above requirements, and weighs in at just over 20K.
  79.     
  80.           The complete source code to LAPTALK is distributed with my MICRO-C
  81.        compiler as an example program. See the enclosed CATALOG file.
  82.     LAPTALK Users Guide                                              Page: 2
  83.  
  84.  
  85.     2. USING LAPTALK
  86.     
  87.           When you first run LAPTALK, it  will  attempt  to  open  the  file
  88.        LAPTALK.CFG in your current directory. If found,  it  will  read  its
  89.        configuration from it.  If  the  configuration  file  is  not  found,
  90.        LAPTALK will display a warning message, and assume various defaults.
  91.     
  92.           Once started, LAPTALK will present you with a  terminal  emulation
  93.        screen. The top 24 lines are the actual data  window,  and  the  25th
  94.        line is a status line. You may now type on the keyboard to send  data
  95.        to the serial port, and see any incoming data in the terminal window.
  96.     
  97.        2.1 Command Line Options
  98.     
  99.              The format of the LAPTALK command line is:
  100.     
  101.                       LAPTALK [-i c=file] [script command]
  102.     
  103.              The '-i' switch tells  LAPTALK  to  NOT  enter  an  interactive
  104.           session. This is most useful when used with a command line  script
  105.           file, so that control will  return  to  DOS  when  the  script  is
  106.           finished.
  107.     
  108.              The 'c=<file>' parameter allows  you  to  specify  a  different
  109.           configuration file which is to be  used  instead  of  the  default
  110.           "LAPTALK.CFG".
  111.     
  112.              If [script command] is given, LAPTALK will  execute  the  named
  113.           script and pass  it  any  additional  arguments  BEFORE  the  main
  114.           interactive mode is entered.
  115.     
  116.        2.2 LAPTALK Functions
  117.     
  118.              To access LAPTALK's functions, press CTRL-HOME or CTRL-END. You
  119.           will be presented with this menu:
  120.     
  121.                                 +--------------+
  122.                                 |Function menu |
  123.                                 |Download file |
  124.                                 |Upload file   |
  125.                                 |Kill capture  |
  126.                                 |Perform script|
  127.                                 |Hangup modem  |
  128.                                 |Clear screen  |
  129.                                 |Configuration |
  130.                                 |Shell to DOS  |
  131.                                 |Exit to DOS   |
  132.                                 +--------------+
  133.     
  134.              You may activate a function by moving  the  highlighted  cursor
  135.           bar to it (with the UP and DOWN arrow keys) and pressing ENTER. To
  136.           quickly move the cursor bar to a particular entry, type the  first
  137.           letter of the entry.
  138.     LAPTALK Users Guide                                              Page: 3
  139.  
  140.  
  141.        2.3 Function menu
  142.     
  143.              This function presents you with a list of "functions" that have
  144.           been configured. Each function  represents  a  "script"  (command)
  145.           file, complete with arguments, that will run when that function is
  146.           selected.
  147.     
  148.              This is a convienent way to set up automatic dialing lists etc.
  149.     
  150.        2.4 Download file
  151.     
  152.              This function will prompt with a menu of  available  protocols,
  153.           and then for the name of  the  file  to  be  transferred.  If  you
  154.           specify a filename which contains wildcard character ('*' or '?'),
  155.           LAPTALK will show you a list of matching files, and allow  you  to
  156.           pick one.
  157.     
  158.              Once the filename is selected, LAPTALK will invoke the selected
  159.           protocol, and attempt to download the file from the remote  system
  160.           to your PC.
  161.     
  162.        2.5 Upload file
  163.     
  164.              This function is similar to "Download file",  except  that  the
  165.           file is transferred from your PC to the remote system.
  166.     
  167.        2.6 Kill capture
  168.     
  169.              This function  is  used  following  a  download  using  "ASCII"
  170.           protocol, to stop LAPTALK from capturing the terminal  session  to
  171.           the file. When an ASCII download is in effect, you  will  see  the
  172.           string "cap" in the status line  at  the  bottom  of  the  screen.
  173.           Selecting this function will stop the  data  capture,  and  remove
  174.           that indication from the status line.
  175.     
  176.        2.7 Perform script
  177.     
  178.              This function prompts for  a  script  filename  and  arguments.
  179.           Unless you specify otherwise, the file is assumed to be located in
  180.           the LAPTALK  home  directory,  and  it  is  assumed  to  have  the
  181.           extension ".SCR". LAPTALK will process  the  file  as  a  "script"
  182.           program.
  183.     
  184.              This method of running a script program  is  useful  for  those
  185.           files which you do not use  frequently  enough  to  have  in  your
  186.           "function  menu".  It  is  also  useful  in  that  you  may  enter
  187.           parameters to the program when you specify its name.
  188.     
  189.              If the filename you supply contains wildcard character ('*'  or
  190.           '?'), LAPTALK will show you a list of the matching  script  files,
  191.           and allow you to select one.
  192.     LAPTALK Users Guide                                              Page: 4
  193.  
  194.  
  195.        2.8 Hangup modem
  196.     
  197.              This command drops the DTR and RTS signals to the modem  for  a
  198.           brief period of time, causing most modems to go offline  and  hang
  199.           up any calls which are in  progress.  See  you  modem  manual